docs/adr/0009-packagist-worker-design-decisions.md:33

• This new ADR does not follow the mandatory repository ADR structure. .claude/rules/adr-format.md:18-28 requires ## Decision, ## Alternatives Considered, and ## Consequences in that order (with Positive/Negative/Risks subsections), but this document uses a living ## Decisions layout and omits the alternatives section. Please restructure it to the enforced template or split the consolidated decisions into compliant ADRs.

## Decisions

docs/adr/0009-packagist-worker-design-decisions.md:33

• This new ADR does not follow .claude/rules/adr-format.md: the mandatory heading is ## Decision (singular), followed by ## Alternatives Considered and ## Consequences with ### Positive, ### Negative, and ### Risks. Those required sections are absent or use a different structure, so please reformat the ADR before merging.

## Decisions

services/apps/packages_worker/src/packagist/activities.ts:225

• A successful response without a numeric downloads.monthly currently becomes a no-op and still advances downloads_30d_last_run_at. Because this lane has no backfill and the month is never revisited, a partial/malformed response permanently loses that month's observation. Treat the missing count as an error (so Temporal retries and eventually records an error) and only mark success after a numeric value is persisted.

  await persistPackagist30dWindow(qx, purl, info.value.package.downloads?.monthly ?? null, runDate)
  await markPackagist30dProcessed(qx, purl, { status: 'success', attempts: info.attempts })

services/libs/data-access-layer/src/packages/versions.ts:165

• This cleanup can change versions.is_latest, but its row count is discarded, so changedFields may omit the only mutation (for example, when the incoming latest was already true while another stale row was also true). persistPackagistMetadata then writes no audit token for the cleanup. Capture the affected-row count and add versions.is_latest when any stale flag was cleared.
  docs/adr/0009-packagist-worker-design-decisions.md:33
• This ADR does not follow the repository's mandatory ADR structure. .claude/rules/adr-format.md:18-28 requires ## Decision, ## Alternatives Considered, and ## Consequences with ### Positive, ### Negative, and ### Risks; this file uses ## Decisions, has no alternatives section, and embeds differently named consequence blocks per decision. Restructure it to the required template or update the governing rule before accepting the ADR.

## Decisions

services/apps/packages_worker/src/packagist/activities.ts:270

• When downloads.daily is absent or non-numeric, this records the run as successful even though no row was inserted. The next schedule uses a new run date, so the missing day is never retried or backfilled. Treat the missing count as an error and only advance the daily watermark after a numeric count has been persisted.

  await markPackagistDailyProcessed(qx, candidate.purl, {
    status: 'success',
    attempts: info.attempts,
  })

docs/adr/0009-packagist-worker-design-decisions.md:33

• This ADR does not follow the repository's mandatory ADR structure: .claude/rules/adr-format.md:18-28 requires ## Decision, ## Alternatives Considered, and ## Consequences with ### Positive, ### Negative, and ### Risks. The current consolidated ## Decisions layout omits those required sections, so it must be restructured or the rule must explicitly define an exemption for living ADRs.

## Decisions

services/apps/packages_worker/src/packagist/activities.ts:339

• This makes the nominal weekly refresh run approximately every two weeks. If run 1 starts at t0, its rows are stamped after t0; run 2 starts at t0 + 7d, computes dueCutoff = t0, and the strict metadata_last_run_at < dueCutoff predicate skips every row written during run 1. Please either select all rows last processed before the current run cutoff for the seed-triggered weekly sweep, or schedule the sweep more frequently and retain the seven-day rolling threshold.

  const dueCutoff = new Date(
    new Date(cutoff).getTime() - metadataRefreshDays() * 24 * 60 * 60 * 1000,
  ).toISOString()

docs/adr/0009-packagist-worker-design-decisions.md:33

• This new ADR does not follow the repository's mandatory ADR structure. .claude/rules/adr-format.md:18-28 requires ## Decision, ## Alternatives Considered, and ## Consequences with ### Positive, ### Negative, and ### Risks; this document uses ## Decisions, has no alternatives section, and nests consequence labels differently. Please restructure it or update the ADR policy separately before adding this accepted ADR.

## Decisions

services/apps/packages_worker/src/packagist/activities.ts:339

• With the default 7-day window and weekly seed schedule, this threshold skips every package processed after the previous run's start: its metadata_last_run_at = NOW() is later than this cutoff - 7 days. Early packages therefore refresh nearly every 14 days, not weekly. Record the fixed workflow cutoff as the watermark (or otherwise compare run anchors) so one run's completion timestamps are eligible on the next weekly run.

  const dueCutoff = new Date(
    new Date(cutoff).getTime() - metadataRefreshDays() * 24 * 60 * 60 * 1000,
  ).toISOString()

services/apps/packages_worker/src/packagist/activities.ts:138

• A terminal NOT_FOUND only advances the state watermark, leaving a deleted Packagist package permanently status = 'active'. Because seeding is insert-only, nothing else will mark that row unpublished, and it remains in future crawls and downstream active-package data. Handle persistent NOT_FOUND by updating the package status while retaining the row for history.

    await markPackagistMetadataScanned(

docs/adr/0009-packagist-worker-design-decisions.md:33

• This new ADR does not follow the repository's mandatory ADR structure: .claude/rules/adr-format.md:18-28 requires ## Decision, ## Alternatives Considered, and ## Consequences with ### Positive, ### Negative, and ### Risks. The plural ## Decisions plus inline consequence labels does not satisfy those headings; please restructure the document or update the governing rule first.

## Decisions